CalendarGcTimeSpanCellType に入力範囲を設定する方法について説明します。

MaxValue、MinValueプロパティを使用

CalendarGcTimeSpanCellType.MaxDate、CalendarGcTimeSpanCellType.MinDate、CalendarGcTimeSpanCellType.MaxMinBehaviorプロパティを使用します。

セルのMaxValueプロパティとMinValueプロパティを設定してセルに入力可能な範囲を指定します。全てのフィールドの値が入力されると検証が行われ、範囲外の場合にはMaxMinBehaviorプロパティの設定によって、値が制御されます。

【設定手順】

CalendarGcTimeSpanCellTypeのMaxValue、MinValueプロパティに最大値、最小値を設定します。

CalendarGcTimeSpanCellTypeのMaxMinBehaviorプロパティを設定します。既定値はAdjustToMaxMinです。

MaxMinBehaviorの値	説明
AdjustToMaxMin	値を最小値か最大値の近い方に設定します。
Clear	値を削除してnull にします。
Restore	変更前の値に戻します。
CancelInput	最後の入力をキャンセルしてフォーカスを保持します。
Keep	エラーとなったText プロパティの値を保持します。

MaxMinBehaviorプロパティをCancelInputに設定した場合、範囲外の最後の入力を行った時点でGcTimeSpan.InvalidInputイベントが発生します。
InvalidInputイベント側では入力された値が範囲外であることを取得できるため、メッセージを出力するなどのカスタマイズが可能です。

以下のサンプルコードは、範囲外の値が入力されたとき、メッセージボックスを表示する例です。

Visual Basic
C#

Imports GrapeCity.Win.CalendarGrid
Imports InputManCell = GrapeCity.Win.CalendarGrid.InputMan
Imports CalendarGridInputMan = GrapeCity.Win.CalendarGrid.Editors

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
    Dim today As DateTime = DateTime.Today

    Dim GcTimeSpanCellType As New InputManCell.CalendarGcTimeSpanCellType()
    ' 最大値と最小値を設定します。
    GcTimeSpanCellType.MaxValue = TimeSpan.Parse("1.00:00:00")
    GcTimeSpanCellType.MinValue = TimeSpan.Parse("00:00:00")

    ' 範囲外の場合に値をどのように制御するかを設定します。
    GcTimeSpanCellType.MaxMinBehavior = InputMan.MaxMinBehavior.CancelInput

    GcCalendarGrid1.Content(today).Rows(1).Cells(0).CellType = GcTimeSpanCellType
    GcCalendarGrid1.ScrollIntoView(today)

    AddHandler GcCalendarGrid1.EditingControlShowing, AddressOf GcCalendarGrid1_EditingControlShowing
End Sub

Private Sub GcCalendarGrid1_EditingControlShowing(sender As Object, e As CalendarEditingControlShowingEventArgs)
    If TypeOf e.Control Is CalendarGridInputMan.GcTimeSpan Then
        Dim editor As CalendarGridInputMan.GcTimeSpan = DirectCast(e.Control, CalendarGridInputMan.GcTimeSpan)

        RemoveHandler editor.InvalidInput, AddressOf editor_InvalidInput
        AddHandler editor.InvalidInput, AddressOf editor_InvalidInput
    End If
End Sub

Private Sub editor_InvalidInput(ByVal sender As System.Object, ByVal e As System.EventArgs)
    Dim InvalidInputEventArgs As CalendarGridInputMan.InvalidInputEventArgs = TryCast(e, CalendarGridInputMan.InvalidInputEventArgs)
    If InvalidInputEventArgs Is Nothing Then
        Exit Sub
    End If

    ' 値が範囲外の場合には、メッセージを表示します。
    If InvalidInputEventArgs.ValueOutOfRange Then
        MessageBox.Show("範囲外の値です。")
    End If
End Sub

using GrapeCity.Win.CalendarGrid;
using InputManCell = GrapeCity.Win.CalendarGrid.InputMan;
using CalendarGridInputMan = GrapeCity.Win.CalendarGrid.Editors;

private void Form1_Load(object sender, EventArgs e)
{
    var today = DateTime.Today;

    var gcTimeSpanCellType = new InputManCell.CalendarGcTimeSpanCellType();

    // 最大値と最小値を設定します。
    gcTimeSpanCellType.MaxValue = TimeSpan.Parse("1.00:00:00");
    gcTimeSpanCellType.MinValue = TimeSpan.Parse("00:00:00");

    // 範囲外の場合に値をどのように制御するかを設定します。
    gcTimeSpanCellType.MaxMinBehavior = InputManCell.MaxMinBehavior.CancelInput;

    gcCalendarGrid1.Content[today].Rows[1].Cells[0].CellType = gcTimeSpanCellType;
    gcCalendarGrid1.ScrollIntoView(today);

    gcCalendarGrid1.EditingControlShowing += gcCalendarGrid1_EditingControlShowing;
}

private void gcCalendarGrid1_EditingControlShowing(object sender, CalendarEditingControlShowingEventArgs e)
{
    if (e.Control is CalendarGridInputMan.GcTimeSpan)
    {
        CalendarGridInputMan.GcTimeSpan editor = (CalendarGridInputMan.GcTimeSpan)e.Control;

        editor.InvalidInput -= editor_InvalidInput;
        editor.InvalidInput += editor_InvalidInput;
    }
}

private void editor_InvalidInput(object sender, EventArgs e)
{
    CalendarGridInputMan.InvalidInputEventArgs invalidInputEventArgs = e as CalendarGridInputMan.InvalidInputEventArgs;
    if (invalidInputEventArgs == null)
    {
        return;
    }

    // 値が範囲外の場合には、メッセージを表示します。
    if (invalidInputEventArgs.ValueOutOfRange)
    {
        MessageBox.Show("範囲外の値です。");
    }
}

参照

GcTimeSpan型セル(CalendarGcTimeSpanCellType)

基本的な使い方(CalendarGcTimeSpanCellType)

入力可能な範囲を設定する(CalendarGcTimeSpanCellType)

外観を変更する(CalendarGcTimeSpanCellType)

書式を設定する(CalendarGcTimeSpanCellType)

視覚的な補助(CalendarGcTimeSpanCellType)

サイドボタンを設定する(CalendarGcTimeSpanCellType)

データベースに接続する(CalendarGcTimeSpanCellType)

サンプルコード(CalendarGcTimeSpanCellType)